home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / lists / gem / l_1199 / 800 < prev    next >
Encoding:
Internet Message Format  |  1994-08-27  |  1.0 KB
  1. From: error@stack.urc.tue.nl (Erlend Nagel)
  2. Subject: Re: The Atari Compendium (relevant topic, actually)
  3. Date: Fri, 15 Jul 1994 11:02:31 +0200 (MET DST)
  4. In-Reply-To:  <9407141118.ab08981@ncrhub1.NCR.COM> from "Chris Herborth" at Jul 14, 94 11:15:11 am
  5. Mime-Version: 1.0
  6. Precedence: bulk
  7.  
  8. Chris wrote:
  9.  
  10. > It once took me as long to write the index for a ~20 page user's manual
  11. > as it did to write the manual!
  12.  
  13. Well, I've found out that in writing, the most useful aids for the
  14. reader take the most time to write. Since an index is one of the most
  15. useful aids in using documentation, I would expect it to cost a lot of
  16. time writing.
  17.  
  18. ST-guide is nice because it can do some sort of indexing automatically.
  19. But it only does one-level indexing, and I still have to find a way of
  20. EXCLUDING some words (that are referenced to from some pages) from the
  21. index. Too bad Holger didn't finish the Nuetzliche Anweisungen zum
  22. schreiben einer hypertext ;-) in the docs...
  23.  
  24. BTW can we postpone this subject a little (as we are now talking about
  25. the user interface)
  26.  
  27. Erlend.
  28.